home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Software Vault: The Gold Collection
/
Software Vault - The Gold Collection (American Databankers) (1993).ISO
/
cdr48
/
prpas.zip
/
PRPAS.DOC
< prev
next >
Wrap
Text File
|
1993-04-14
|
9KB
|
196 lines
PrettyPascal 1.0
Invariant Software
P.O. Box 10206
Spokane, WA 99209
509-327-2154 (Greg)
INTRODUCTION
PrettyPascal is intended for Pascal programmers to help make program
files more legible by spacing operators, procedure calls, and control
guards, and by reformatting the code to a specified style and
indentation preference. PrettyPascal is comprised of the following
files:
PRPAS.EXE Executable file.
PRPAS.DOC User manual.
INVOICE.DOC Registration.
PRPSETUP.DAT Data file for format parameters.
READ.ME Brief description and instructions.
SAMPLE.PAS Pascal program file for testing PrettyPascal.
PrettyPascal is distributed as Shareware. This means that Pretty-
Pascal is commercial software distributed on a try before you buy basis.
Try PrettyPascal for a couple of weeks, then if you find it useful,
register it.
REGISTRATION and BENEFITS
All that is required is a one time registration fee of $30. For
your $30, you will receive telephone support, announcements of enhance-
ments and future versions of PrettyPascal, and any other Shareware
released by Invariant Software.
INSTALLATION
To make PrettyPascal the most useful, copy the PRPAS.EXE and
PRPSETUP.DAT files to a directory that is pointed to by the PATH
statement used by your DOS. This statement is located in your
AUTOEXEC.BAT. PrettyPascal requires a PC compatible computer and 360K
of memory.
USING PrettyPascal
CALLING from DOS
syntax: prpas [drive:][path]filename [*.extension]
Examples:
prpas file1.pas {original file overwritten}
prpas c:\src\file1.pas
prpas *.pas
prpas file1.pas *.fmt {formatted file "file1.fmt"}
prpas c:\src\*.pas *.fmt
prpas *.pas *.e
Note: The target file option must be of the form "*.XXX". If
the target file option is not exercised the formatted file
will overwrite the original file.
RESTRICTIONS
a. Program comments are not affected except for positioning
within procedure blocks.
b. All word operators such as 'and', 'div', 'mod', 'or', 'shl',
'shr' and 'xor' are ignored for spacing.
c. There is a size limitation for procedures/functions within
files which is dependent on the indentation spaces. For
example, a 40k byte procedure and an indentation of 5 exceeds
the 65k limit; however, the same procedure and an indentation
of 2 is fine. There is no retriction for the file size.
d. Brackets "[ ]" are not recognized as delimiters for the "with"
statement.
e. Case statements which use "otherwise" as the default branch
may not format correctly in some instances. Program logic,
however, is not affected.
f. Procedures are indented based on the original position of
"begin" and the nearest non space and non tab to the left.
g. All files must be ASCII text files, use standard pascal
syntax, and be error-free compiled files. Syntax errors may
result in a runtime error.
USER INTERFACE
If valid arguments were given, the initial screen is displayed
with the default format parameters. The parameters represent your
last use of the program and are saved in PRPSETUP.dat.
The screen is made up of four sections - indentation spaces,
function style selection, control style selection, and character
spacing. All possible key actions are detailed in the box at the
bottom of the screen and in the help screen. Press <Enter> to move
from one section to another, press <Esc> to terminate the program,
press <CTRL-R> to run formatting, and press <?> for the help screen.
Indentation spaces: Press '1','2','3',... or '9' to change
indentation.
Function Style and Control Style: Use up and down arrows to select
the desired style.
Spacing:
A 'space' character is marked with a '^' underneath and
designates movable characters so that the desired spacing can be
expressed. A 'space' character can be moved to the left (if a
blank space exists to the left) or to the right using the
<backspace> and <space bar> respectively. The cursor is moved
from one 'space' character to another using arrow keys.
A 'case' character is marked with a '-' underneath and are used
to designate the capitalization or non-capitalization of reserved
words. Type "IF", "if", "If" or "iF" to specify the desired
captalization. The following words will be affected throughout
the file except within comments:
"absolute","and","array","asm","begin","case","const",
"contructor","destructor","div","do","downto","else","end",
"external","file","for","forward","function","goto","if",
"implementation","in","inline","interface","interrupt","label",
"mod","nil","not","object","of","or","packed","procedure",
"program","record","repeat","set","shl","shr","string","then",
"to","type","unit","until","uses","var","virtual","while",
"with", and "xor"
These words represent the Turbo Pascal 6 reserved word list.
A 'parenthesis' character is marked with a '*' underneath and
are used to specify whether or not you wish to parenthesize
control guards (i.e. "if x=1 then" or "if (x=1) then"). To
designate, position the cursor at the 'parenthesis' character
and type '(' or ')' to add or delete parentheses.
DISCLAIMER
Invariant Software disclaims all warranties, expressed or implied,
relating to this product as to the merchantability and/or fitness for
a particular purpose. Invariant Software shall not be liable for
any damages whether they be direct, indirect, special, consequential,
or incidental arising from a failure of this program to operate in
the manner desired by the user. Invariant Software shall not be
liable for any damage to data or property which may be caused directly
or indirectly by the use of this program. THE PERSON USING THIS
SOFTWARE ASSUMES ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THIS
SOFTWARE.
RESPONSIBILITY of USER
This software is copyrighted under the U.S. copyright laws. No
person shall knowingly modify or distribute a modified version of this
software.
Further, it is the responsibility of the user to pay for this
software if they find it useful, and not to use any longer than a
two week evaluation period.
This software is distributed as Shareware and may be freely
distributed among other users within the limits as imposed above.
You are requested to pass this program out for trial use, and under
no circumstances charge a fee other than the cost of a distribution
disk.
If you have any questions regarding PrettyPascal, site licenses or if
you have any suggestions, call 509-327-2154 and ask for Greg.
INVOICE/REGISTRATION for PrettyPascal 1.0
Send to: Invariant Software or Invariant Software
P.O. Box 10206 3117 W. Gordon
Spokane, WA 99209 Spokane, WA 99205
509-327-2154
From:
Name: _____________________________________________
Address: _____________________________________________
City, State
and Zip Code: _____________________________________________
Phone Number: _____________________________________________
( if applicatable )
Company: _____________________________________________
Title: _____________________________________________
Registration and notification of upgrades
and other products .........................$30.00 ea. _______
Washington Residents add 8.0% Sales Tax ($2.40 ea.)... _______
Total Enclosed ....................................... _______
Terms: Check Drawn on U.S. Bank in U.S. Funds,
International Bank or Postal Money Order